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CHAPTER 1 
INTRODUCTION 

DDT-10 (for Dynamic Debugging Technique)* is used for on-line checkout and testing of 
MACRO-10 and FORTRAN programs and on-line program composition in all PDP-10 software systems. 

After the user's source program has been assembled or compiled, the user's binary object 
program (with its symbol table) may be loaded along with DDT. DDT occupies about 2K of core. 

By typing commands to DDT, the user may set breakpoints where DDT will suspend execution 
of his program and await further commands. This allows the user to check out his program section by 
section. Either before starting execution or during breakpoint stops, the user may examine and modify 
the contents of any location. Insertions and deletions may be done in symbolic source language or in 
various numeric and text modes at the user's option. DDT also performs searches, gives conditional 
dumps, and calls user-coded debugging subroutines at breakpoints. 

Symbolic on-line debugging with DDT provides a means for rapid checkout of new programs. 
If a bug is detected, the programmer makes changes quickly and easily and may then immediately exe- 
cute the corrected section of his program. 

1.1 LOADING PROCEDURE 

The user loads the program to be debugged and DDT with the Linking Loader. (The /D 
switch commands the Loader to load DDT.) To transfer control to DDT, the user types the monitor 
command, 

DDT;, 

After DOT responds by skipping two lines, the user may begin typing commands to DDT. 

1.2 LEARNING TO USE DDT 

This manual is designed to make DDT easy to use. A survey was made of several program- 
mers who use DDT frequently, and it was learned that most debugging is done with a limited set of 
commands. These basic commands are described in the next chapter. When learning DDT, it is re- 
commended that the reader concentrate on learning to use the commands in Chapter 2. If more de- 
tailed information is required, skip ahead to later chapters. 
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After reading Chapter 2, practice debugging, using the basic commands. This may be all 
that will ever be needed. Read the following chapters which describe the entire command set in detail; 
this should be read when the basic commands are understood . 

After learning the system, the Summary of Commands, listed by function in Appendix A, will 
be useful for quickly finding any DDT command. 
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CHAPTER 2 
BASIC DDT COMMANDS 

The DDT commands most frequently used by programm s are described in this chapter. Many 
programs are debugged successfully using only these basic commands. 

This chapter introduces the main features of DDT to the uninitiated user. Later chapters 
describe in detail these basic commands, less frequently used commands and other more complex options. 

2.1 EXAMINING STORAGE WORDS 



By using DDT, a programmer may examine the contents of any storage word by typing the 
address of the desired word followed immediately by a slash (/). For example, to type out the con- 
tents of a location whose symbolic address is CAT, the user types, 

CAT/ 
DDT now types out rhe contents (preceded and followed by tabs) on the same line . 

CAT/ MOVEM AC*D0G+21 



The word labeled CAT is now considered to be opened, and DDT has set its location pointer 
to point to this address. 

2.2 TYPE-OUT MODES 



The preceding example showed DDT typing out the contents of location CAT as a symbolic 
instruction with its address field also relative to a symbol . This is the type-out mode in which DDT is 

initialized. It is also initialized to type all numbers in the octal radix. The user may ask DDT to re- 

2 

type the preceding quantity as a number in the current radix by typing an equal sign (=). For example , 

CAT/ MOVEM AC>D0G+21 = 20g400>#6736 
DDT has numerous commands which reset the type-out mode permanently, temporarily, or 
for only one typeout. The modes that can be selected include numeric constants, floating point numbers, 
ASCII and SIX BIT text modes, and half-word format. Absolute or relative addressing and different 
radixes may similarly be selected. For example, to change the current type-out mode to ASCII text, 
the user types the command^ 

$T 




In this manual information typed out by DDT is underlined to distinguish DDT output 
„from user-typed input. 

The two commas indicate that 202400 is in the left half of CAT, and 6736 is in the 
-right half. 

The Teletype keys ALTMODE (ALT), PREFIX (PRERX), or ESCAPE (ESC) are all 

equivalent and echo as $. 
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or, to change the current type-out mode to half-word format, he types 

$H 
or, to select decimal numbers in his typeouts, he types 

$10R 
Using these commands (and others described in Chapter 3), a programmer may examine any 
location in the mode most appropriate to the information stored there. A semicolon (;) commands 
DDT to retype the preceding quantity in the current mode. Combining this command with a mode 
change gives results such as the following: 

CAT/ MOVEM AC>DOG+gl SlfdRi MOVEM AC^DQG + 17 
or CAT/ MOVEM AC*D0G+21 $H; 202400 j >D0G+21 



or TEXT/ ANDM 1*342212(10) $T; ABCDE 



2.3 MODIFYING STORAGE WORDS 

Once a word has been opened, its contents may be changed by typing the desired new con- 
tents immediately following the typeout produced by DDT. A carriage return will command DDT to 
make the indicated modification and close the word. For example, 

CAT/ MOVEN! AC#D0G+21 MOVNM AC2*D0G+21 ) 
The carriage return simply closes the previously examined register without opening another . 
The line feed ( i ) may also be used to close a word after examining (and optionally modifying) it. The 
line feed commands DDT to (1) echo a carriage return, (2) close the current word (making a modi- 
fication if one was typed), (3) add one to DDT's location pointer, and (4) type out the new pointer 
value and the contents of that address. Thus, if a line feed had been used in the previous example, 
the result would be: 

CAT/ MOVEM AC>D0G+21 MOVNM AC2*D0G+2Ij 
CAT+1/ AOBJN XR6*L00P5 
Location CAT+1 is now open and may be modified if desired. 

The vertical arrow ( t ) is similar to the line feed command except that the location counter 
is decremented by one. Therefore, if the user continued the previous example by typing t the result 
would be 

CAT+l/ AOBJN XR6# LOOPSt 
CAT/ MOVNM AC2#D0G+2l 



1 ^ 

The carriage return command has the additional property of causing temporary 
type-out modes to revert to permanent mode. 
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LocaHon CAT is thus displayed and shows the result of the modification made in the previous 

example. 

The tab ( H ) and backslash ( \) both close the current register and open the address last 
typed (whether typed by DDT or the user). However, tab sets DDT's location pointer ( . ) to this new 
address while backslash leaves it unaltered. A more complex example may clarify the usefulness of 

these commands. 

CAT+1/ AOBJN XR6>l00P5 H 

LOOPS/ CAMGE ACg,TABL(XR6 ) CAMG AC2,TABL-.l CXR6 )N SETZI = 401000. >M 

L0OP5+1/ JUMPL AG3> FAULT JUMPL AC2. FAULT H 

FAULT/ JRST 4 > FAULT 

2.4 TYPE-IN MODES 

The examples in the preceding section showed modifications made as symbolic instructions in 
a form identical to MACRO-10 machine language. It is also possible to enter various numbers and 

forms of text . 

Octal values may be typed in as octal integers with no decimal point. To be interpreted as a 
decimal number, an integer must be followed by a decimal point. Numeric strings with numbers follow- 
ing the decimal point imply decimal floating-point numbers. The E-notation may also be used on 
floating-point numbers. Some examples are: 

Octal: 1234 777777777777 -6 

Decimal integers: 6789. 99999999. -25. 0. 

Floating-point numbers: 78.1 0.249876E-10 -4.00E+20 0.0 

Incorrect formats: 76E+2 76. E+2 (instead write 76. OE+2) 

To enter ASCII text (up to five characters, left justified in a word), type a double quote ( ") 
followed by any printing character to serve as d delimiter, then type the one to five ASCII characters 
and repeat the delimiter. For example: 

"/ABCDE/ (/ is the delimiter) 

"ABCDA (A is the delimiter) 

Note that the mode of a quantity typed in is determined by the user's input format and is 
unaffected by any type-out mode settings. 

2.5 SYMBOLS 

The user's symbol tables are loaded by the Linking Loader when it loads programs and DDT. 
However, initially DDT is set to treat only global symbols (created by INTERNAL and ENTRY pseudo- 
ops in MACRO-10) as being defined. This means that only global symbols will be used for relative 
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address typeouts and, likewise, only these globals can be referenced when typing in symbolic modifica- 
tions. In order to make the local symbols within a particular program available to DDT, the user types 
the program name (this comes from the MACRO-10 TITLE statement or the FORTRAN IV SUBROUTINE or 
FUNCTION statement) followed by ALTMODE and a colon ($:). For example, the command 
ARCTANS: 

will unlock the local symbols in the program named ARCTAN. This provision in DDT permits the user to 
debug several related subroutines simultaneously and reference the local symbol table of each indepen- 
dently without fear of multiply-defined local symbols. If the user's program is not titled, the command 
MAIN.$: will unlock the local symbol table. 

NOTE 

DDT is not quite so stringent on the use of local sym- 
bols as indicated above (see Section 5.6). However, 
the user is advised to unlock symbols with $: until he 
is fairly familiar with DDT. 

The user may also insert symbols into the symbol table. To insert a symbol with a particular 
value, type the value, followed by a left angle bracket (<), the symbol, and a colon (: ). Some exam- 
ples are 707<CONSj 27<S: 1 2 . 1 E+<NUN3B s ADR + lg<ADRX: 

To assign a symbol with a value equal to DDT's location pointer, simply type the symbol fol- 
lowed by a colon. For example, 

XREF + 4/ JRST e TABLO) BRNCHJ 

will cause BRNCH to be defined with the value XFER+4. 

2.6 EXPRESSIONS 

DDT permits the user to combine symbols and numeric quantities into expressions by using the 
following characters to indicate arithmetic operators. 

+ The plus sign indicates 2's complement addition 
- The minus sign indicates 2's complement subtraction 
The asterisk indicates integer multiplication 

The single quote or apostrophe indicates integer division (remainder discarded)-- 
slash cannot be used to indicate division since it has another use in DDT. 

As usual in arithmetic expressions, the evaluation proceeds from left to right with multiplica- 
tion and division performed before oddition and subtraction. 

2.7 BREAKPOINTS 

The breakpoint facility in DDT provides a means of suspending program operation at any de- 
sired point to examine partial results and thus debug a program section by section. The simpler facts 
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about breakpoints are presented next; the use and control of conditional breakpoints is deferred to Para- 
graph 4.2. 

2.7.1 Setting Breakpoints 

The programmer can automatically stop his program at strategic points by setting as many as 
eight breakpoints. Breakpoints may be set before the debugging run is started, or during another break- 
point stop. To set a breakpoint, the programmer types the symbolic or absolute address of the word at 
the location point in which he wants the program to stop, followed by $B. For example, to stop when 
location 6004 is reached, he types, 

6004$B 
Breakpoint numbers are normally assigned by DDT in sequence from 1 to 8. The user may in- 
stead assign breakpoint numbers himself when he sets a breakpoint by typing, 

$NB 
when n is the breakpoint number (Kn<8), for example, 

CAT+3S4B D0G+1$7B 6004$8B 
When the programmer sets up a breakpoint he may request that the contents of a specified 
word be typed out when the breakpoint is reached. To do this, the address of the word to be examined 
is inserted, followed by two commas, before the breakpoint address. Some examples are 

D0Gj*CAT$3B AC1**L00P+2$B X**6004$8B 

2.7.2 Breakpoint Restrictions 

The locations where breakpoints are set may not 

a. be modified by the program 

b. be used as data or literals 

c. be used as part of an indirect addressing chain 

d. contain the user mode monitor command INIT 

e. be accumulator 0. 

2.7.3 Breakpoint Type-Outs 

When the breakpoint location is reached, DDT suspends program execution without executing 
the instruction at the breakpoint location. DDT then types the breakpoint number and the Program 
Counter value at the time the breakpoint is reached (this value will differ from the typed-ln breakpoint 
address if the breakpoint is executed by an XCT instruction elsewhere in the program). The format of 
this typeout is as shown in the following examples: 

SAB >> CAT+3 $7B >> DOG+1 $8B >> 6004 
If the user requested that a specified address be examined at that breakpoint, it will be 
opened; for example, 

$3B >> CAT DOG/ SOJGE 3*G0AT+6 
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2.7.4 Removing and Reassigning Breakpoints 

The user may remove a breakpoint by typing, 

0$NB 
where n is the number of the breakpoint to be removed. For example, 

0$2B 
removes the second breakpoint. All assigned breakpoints are removed by typing 

$B 
The user may reassign a breakpoint without formally removing it. Thus, if he has set breakpoint No. 2 
at location ADR (via the command ADR$2B) he may reassign No. 2 to LOC+6 by typing LOC+6$2B. 

2.7.5 Proceeding From a Breakpoint 



Program execution may be resumed (in sequence) following a breakpoint stop by typing the 
proceed command, $P. 

If the user does not wish to stop until the nth time that this breakpoint is encountered he 
types, 

N$P 
Then this breakpoint will be passed n-l times before a break occurs. 

2.8 STARTING THE PROGRAM 



The program is started by typing 

$G 
This starts the program at the previously specified starting address in location JOBSA. (Typically this 
is the address from the MACRO-10 END statement.) The programmer may start at any other location 
by typing that address followed by $G. For example, 

4000$G 
Starts the program at the instruction stored at location 4000. BEGiN$G starts the program at the sym- 
bolic location BEGIN. 

The start command may also be used to restart from a breakpoint stop when it is not desired 
to continue in sequence from the point where program execution was suspended. 

2.9 DELETING TYPING ERRORS 



Any partially typed command may be deleted by pressing the RUB OUT key. This causes 
DDT to ignore any preceding (unexecuted) partial command, and DDT types XXX. The correct com- 
mand may then be retyped . 
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2.10 ERROR MESSAGES 

If the user types an undefined symbol which cannot be interpreted by DDT, U is typed back. 
If an illegal DDT command is typed, or a location outside the user's assigned memory area is referenced 
? is typed back . 

2.11 SUMMARY 

As was said in the beginning, these basic commands are sufficient for debugging many 
programs. Complete descriptions of all DDT commands are explained in the following chapters. 
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CHAPTERS 
DDTCOMAAANDS 

When DDT is initialized, if is set to type out in the symbolic instruction format with relative 
addresses/ and to type out numbers in octal radix. 

3. ] EXAMINING THE CONTENTS OF A PROGRAM STORAGE WORD 



To type out the contents of a storage word, the programmer types the address, followed imme- 
diately by a slash (/). For example, to examine the contents of a word whose symbolic address is ADR, 
the user types, 

ADR/ 

DDT types out the contents on the same line. In this manual, information typed out by DDT is under- 
lined. 

ADR/ MOVE A#CC1 



The word labeled ADR is now considered to be opened, and DDT continues to point to this address. 
The point, or period, character (.) represents DDT's location pointer, and may be used to type out its 
contents, as in the following command. 

./ MOVE A> CCl 
Since we did not change the contents^ they are the same, but we used the location pointer to re- 
examine the currently opened word. Similarly, the programmer may use the period (.) as an arithmetic 
expression component, such as 

. + 5/ SOJGE 2^ADRh-3 
DDT's location pointer is set to a new value by the /command when immediately preceded by an ad- 
dress. For example, 

201/ _0_ 
sets the location pointer to 201 . If the user types / without typing an address, the contents of the loca- 
tion addressed in the last typeout are typed. 

667/ MOVE 1>6 / 

./ MOVE 1#6 




Location 667 contains the instruction MOVE 1 ,6. The second slash displays the contents of Accumu- 
lator 6, which is zero. This does not change the location pointer, which is still pointing to location 667. 
ADR/ MOVE A>CC 1 / ADD 2^SUM-«-7 
It should also be noted that the spaces, which occur after DDT completes ftie typing of the con- 
tents of ADR, are automatically produced by DDT, not the user. 
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The left square bracket ([)' has the same effect as the slash, (the address immediately 
preceding the [ will be opened). However, [ forces the typeout to be in numbers of the current radix. 

ADRC _1_L ^ OCTAL) 

ADR3 ±2. ^DECIMAL) 
The right bracket (3)^ has the same effect as the slash except that it forces the typeout to be in sym- 
bolic instructions. 

ADR +23 3 MOVE 15>LIST+2 

The exclamation point (!) works like the slash except that it suppresses type out of contents 
of locations until either /, C/ or ] is typed by the user. The LINE FEED (0 commands DDT to type 
out the contents of ADR+1 . 

ADR! MOVE AC^SSSJ (1 ) 

ADR + 1 \ } <2) 

ADR/ MOVE AC*555 <3) 

Thus, in step (1) of the example the contents of ADR are not typed out, but the address is opened to 
modification and MOVE AC, 555 has been typed in by the user. 

Step (2) of the example shows that the location pointer has been incremented by one and the 
contents of ADR+1 are not typed out. This is because the exclamation point is still in effect and will 
continue to take effect until /, [, or ] is typed in by the user. In this case, the slash terminates the 
effect of the exclamation point. 

Step (3) shows that the modification (MOVE AC, 555) of ADR typed in Step (1) has been 
accomplished. 

3 . 2 CHAMPING THE CONTENTS OF A WORD 

After a word is opened, its contents can be changed by typing the new contents following 
the type out by DDT, followed by a carriage return. For example, 

ADR/ MOVE Aj>CC1 MOVE A*CC2 ^ 
The carriage return closes the open word, but does not move the location pointer. A LINE FEED (I) 
command could also be used to make this modification. A LINE FEED causes a carriage return, adds 



On Teletype Models 33 and 35 the left square bracket ([) is produced by holding the SHIFT key down 
and striking the K key. The right square bracket (]), is produced by holding the SHIFT key down and 
striking the M key. 
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one to DDT's location counter (moves the pointer), types out the resulting address and the contents of 
the new address. Thus, if we conclude our last example with a LINE FEED 

ADR/ MOVE A^CCl MOVE A,CC2i 

ADR+1/ ADD 3,CC3 
ADR+1 is now open, and may be modified by the user. 

The vertical arrow (t) works similarly, except that one is subtracted from the location 
pointer. The open word is closed (modified if a change is given) and the new address and contents are 
typed out. 

ADR+1/ ADD 3>CC3t 

ADR/ MOVE A,CC2 



Since the vertical arrow subtracts one from the pointer, the resulting address is ADR, and 
the contents now show the change made in the previous example. 

3.3 INSERTING A CHANGE, AND EXAMINING THE CONTENTS OF THE LAST TYPED 

ADDRESS 

The horizontal tab ( -H ) causes a carriage -return line feed, then sets the location pointer to 
the last address typed (the new address if a modification was made) of the instruction in the register 
just closed. Then DDT types this new address, followed by a slash and the contents of that location, 
as shown below. 

ADR5/ JRST ADR l JRST ADR H 

ADR/ MOVEM B.>CCg -«| 

CC2 / 666 

The backslash {\'^ opens the word at the last address typed and types out the contents. 
However, backslash does not change the location pointer. The backslash closes the previously opened 
word and causes it to be modified if a new quantity has been typed in. 

ADR/ MOVE A^CCg JRST X\ MOVE AC>3 

The use of the backslash accomplishes two things. First it changes ADR by replacing its contents with 
JRST X. Second, the backslash causes DDT to type out the contents of X, namely, MOVE AC, 3. The 
location pointer continues to point to ADR, but now location X is open and may be modified if desired. 




t is produced by SHIFT-N on Teletype Models 33 and 35. The backspace key may be used instead of 

t on Teletype Model 37. 
2 
\is produced by SHIFT-L on Teletype Models 33 and 35. 
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If the line-feed control character and the vertical arrow were used in conjunction with the 
backslash, the results would be as follows. 

ADR/ MOVEN^i B^CC2 MOVE A#CC1\ 105776 ^ 

ADR+i/ MOVE A,C f 



ADR/ 



MOVE A*CC1 \ 105776 



The following is a summary in table form of these special control characters and their cor- 
responding functions. For example, the chart shows that the forward slash (/) will examine the Con- 
tents of an address, type out in the current mode, open the address, change the location pointer to the 
address just opened, but it does not cause a new quantity to be inserted in that address. 



Table 3-1 
Special Character Functions 



Command 
Character 


Type Out 
Contents 


Mode 


Address 
Opened 


Change 

Location 

Pointer 


Insert New 

Qfy If New 

Qty Has Been 

Typed 


/ 
[ 
] 
1 


Yes 
Yes 
Yes 
No 


Current 
Numeric 
Symbolic 
None 


> Yes 


Y«' 


No 


\ 


Y«2 


Current 


Yes 


No 


Yes 


TAB(H) 


Yes^ 


Current 


Yes 


Yes 


Yes 


t or backspace 


Yes^ 


Current 


Yes 


Yes (.-1) 


Yes 


Line-feed (l) 


Yes^ 


Current 


Yes 


Yes (.+1) 


Yes 


Carriage 
return (^) 


No 


None 


No 
(closes) 


No 


Yes 



A ? typed by DDT when examining a location indicates that the address of the location is 
outside the user's assigned memory area. A ? typed when depositing indicates that the location cannot 
be written in, because it is either outside the assigned memory area or inside a write -protected memory 
segment. 



^If a user-typed quantity preceded , 
If I has not suppressed typeout. 
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3.4 STARTING THE PROGRAM 

The program is started by typing 
$G 
This starts the program with the instruction beginning at the user's previously specified starting address 
taken from location JOBSA. The programmer may start at any other instruction by typing the address of 
that instruction followed by $G. For example, 

4000SG OR ADR+5£G 
Starts the program at the instruction stored at location 4000 or, in the second part, at the symbolic 
address ADR+5. The start command may also be used to restart from breakpoints when the user does not 
wish to proceed to the next instruction . 

3.5 ONE-TIME TYPEOUTS 



These commands cause a single typeout of the opened word in the mode indicated. 

3.5.1 Type Out Numeric 

Although DDT is initialized to type out in symbolic mode, it is often useful to change to 
numeric typeout. When the programmer types the equal sign (=), the last expression typed is retyped by 
DDT in the current radix (initially octal). This is useful when a symbolic typeout is meaningless. Since 
this usually indicates that numeric data is stored in that word, the user can verify this by typing = and 
checking the value. 

3.5.2 Type Out Symbolic 



If a typeout is numeric, and the user wants to examine it in symbolic mode, he types the left 
arrow {-). The last typed quantity is retyped as a symbolic instruction. The address mode is determined 
by$Aor$R. 

3.5.3 Type Out in Curren t Mode 

To retype a typeout in the current mode, the user types a semicolon (;). This may be used, 
for example, if the user has changed the typeout mode. For example, 

TEXT/ ANDM 1,342212 (t0) ST i ABCDE 

3.6 SYMBOLS 



Before DDT commands can be used to reference local symbols in the program Symbol Table, the 
user should type the program name as specified in theMACRO-10 TITLE statement, or the FORTRAN IV 
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SUBROUTINE or FUNCTION statement, followed by an ALTMODE and a colon. For example, 

MAINS: 
makes the local symbols in the program called MAIN available. Since the user can debug several re- 
lated subroutines simultaneously, reference to several independent symbol tables is permitted, each of 
which may use the same local symbols with differenl values. DDT allows the user to reference unique 
local symbols in other programs without respecifying the program name with $: (see Section 5.6.2). 
However, to access a local symbol that is used in several programs, the user must specify the program 
name to remove the ambiguity. Global symbols, such as those specified in MACRO- 10 INTERNAL 
statements, may always be referenced. 

The user may insert (or redefine) a symbol in the symbol table by typing the symbol, followed 
by a colon. The symbol will have a value equal to the address of the location pointer ( . ). 

X/ ADDl 3>N TAG : 
causes TAG to be defined with the same value as X. All user defined symbols are global . 

The user may also directly assign a value to a symbol by typing the value, a left angle 
bracket (<) and the symbol, terminated by a colon. This is the equivalent of a MACRO-10 direct as- 
signment statement. Some examples are, 

707<CONS: 12.1E+2<NUMB: 
27<X: 101<MIL: 

3.7 TYPING IN 

To change or modify the contents of a word, the user may type symbolic instructions, num- 
bers, and text characters. Type-ins are interpreted by DDT in context. That is, DDT tests the data typed 
in to determine whether it is to be interpreted as an instruction, a number (octal or decimal), or text. 
Typeout mode settings, such as $S, $C, and $nR, do not affect typed input. 

The user may type the following: 

a. Symbolic Instructions 

b. Numbers 

(1) Octal integers 

(2) Fixed-point decimal integers 

(3) Floating-point decimal mixed numbers 

c . Text 

(1) Up to five PDP-10 ASCII characters, left justified in a word 

(2) Up to six SIXBIT characters, left justified in a word 

(3) A single PDP-10 ASCII character, right justified in a word 

(4) A single SIXBIT character, right justified in a word 

d. Symbols 

Anything that is not a number or text is interpreted by DDT as a symbol . 
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3.7.1 Typing In Symbolic Instructions 

In general, a symbolic instruction is written for insertion by DDT, in the same way the in- 
struction is written as a MACRO-10 source program statement. For example, 

X/ _0_ ADD ACl >DATE 
where a space terminates the operation field, and a comma terminates the accumulator field. For 
example: (1) In DDT, the operation code determines the interpretation of the accumulator field . If 
an I/O instruction is used, DDT inserts the l/O device number in the correct place, and (2) indirect 
and indexed addresses are written, as in MACRO-10 statements, where @ precedes the address to set 
the indirect bit, and the index register specified follows in parentheses. 
X/0 ADD 4>@NUM<17) 
To type in two 18-bit halfwords, the left and right expressions are separated by two commas. 

For example, 

X/ _0 A*>B 
This is similar to the MACRO-10 statement 

XWD A*B 

3.7.2 Typing In Numbers 



A typed-in number is interpreted by DDT as octal if it does not contain a decimal point. 

The following examples are octal type-ins: 

1234 -10101 

772 777777777777 

Fixed-point decimal integers must contain a decimal point with no digits following. 

1234. -99. 877. 
Floating-point numbers may be written in two formats. With a decimal point and a digit following the 

decimal point: 

101.1 1234.5 999.0 -2.71828 

Or as in MACRO-10, with E indicating exponentiation: 

12.0E+2 77.0E+5 12.34E2 31.4159E-1 

3.7.3 Typing In Text Characters 

To type in up to five PDP-10 ASCII characters, left justified in an opened word, the user 
types a quotation mark, followed by any printing delimiting character, then the text characters, and 
terminated by the delimiting character. The following examples are legal: 

"/TEXT/ "ABCDEFA In these cases, /and A are 

the delimiting characters 
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To type in up to six SIXBIT characters, left justified in an opened word, the user types ALTMODE quo- 
tation mark ($"), followed by any delimiting character, then the text characters, and terminated by re- 
peating the delimiting character. Lower case letters are converted to upper case. Characters outside 
the SIXBIT set are illegal, and DDT types a question mark. The two examples below are SIXBIT type ins. 

S'VDIVIDE/ £"EXXXXXXE 
To type in a single PDP-10 ASCII character, right justified in an opened word, the user types 
a quotation mark, followed by a single ASCII text character, then by an ALTMODE. 

"0$ "/£ "?$ 
To type in a single SIXBIT character, right justified in an opened word, the user types an 
ALTMODE, followed by a quotation mark, a single SIXBIT text character and terminated by an ALT- 
MODE. 

$••0$ $"MS £"$£ 

3.7.4 Arithmetic Expressions 

Numbers and symbols may be combined into expressions using the following characters to in- 
dicate arithmetic operations. 

+ The plus sign means 2's complement integer addition. 
- The minus sign means 2's complement integer subtraction. 
* The asterisk means integer multiplication. 

The single quote means integer division with any remainder discarded. (The slash has 
another f uncti on . ) 

Symbols and numbers are combined by +, -, *, ' to form expressions. Examples: 

6+2 

S'2.51+BASE 
2*3 + 1 

3.8 DELETE 

Any partially typed command may be deleted by pressing the RUB OUT or DELete key. This 
causes DDT to ignore any preceding (unexecuted) partial command and DDT types XXX. The correct 
command may then be retyped . 

3.9 ERROR MESSAGES 

If the user types an undefined symbol which cannot be interpreted by DDT, U is typed back. 
If an illegal DDT command is typed, ? is typed back. Examining or depositing into a location outside 
the user's assigned memory area causes DDT to type a ?. Depositing in a write-protected high memory 
segment also results in a ? typeoulL 
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3.10 UPPER AND LOWER CASE gELETYP^ MODEL 37 ) 

DDT will accepf alphabetic input in either upper or lower case. Lower case letters are in- 
ternally converted to upper case, except when inputting text where they are taken literally as explained 
in Section 3.7.3. 

DDT output is in upper case, except for text which is taken literally. 
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CHAPTER 4 
MORE DDT- 10 COMMANDS 

This chapter describes other type-out modes, conditional breakpoints, searches and addition- 
al features. Commands are available to change modes from the initial settings so that numeric data can 
be typed out in a radix chosen by the user, in floating-point format, in RADIX50 format, as halfwords 
(two addresses) and as bytes of any size. The contents of a storage word may also be typed out as 7-bit 
PDP-10 ASCII text, or SIXBIT text characters. (See MACRO-10 Manual, Appendix E.) 

Searches can be made in any part of the program for any word, not-word (inequality), or ef- 
fective address. The user specifies the instruction or data to be searched for and the limits of the 
search. 

Breakpoints can be set condiHonally, so that a program stop occurs if the condition is satis- 
fied. In addition, a counter can be set up allowing the user to specify the number of times a breakpoint 
is passed before a program stop occurs . 

4.1 CHANGING THE OUTPUT RADIX 

Any radix (>2) may be set by typing $nR, where n is the radix for the next typeout only, and 
n is interpreted by DDT as a decimal value. The radix is permanently changed when the double ALT- 
MODE is used in the command $$nR. To change the type-out radix permanently to decimal, the user 
types, 

S£I0R 
When the output radix is decimal, DDT follows all numbers with a point. 

4.2 TYPE-OUT MODES 

When DDT-10 is loaded, the type-out modes are initialized to produce symbolic instructions 
with addresses relative to symbolic locations. For numeric typeouts, the radix is initially set to octal . 

These modes may be changed by the user. The duration, or lasting effect of a type-out mode 
change is also set by the user. Prevailing modes, which are semipermanent, are preceded by two ALT- 
MODEs. Temporary modes are preceded by a single ALTMODE. In addition, some mode changes ef- 
fect only one typeout, such as the equal sign, which causes DDT to retype the last typed quantity in 
numeric mode. 

In general, prevailing modes are changed by replacing them with another prevailing mode or 
by reinitializing the system. Temporary modes remain in effect until the user types a carriage return 
i) ), or re-enters DDT. One-time modes apply only to a single typeout. 
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4.2.1 Primary Type-out Modes 

$S COR S$S) Type out symbolic instructions. Tiie address part interpretation 

is set by $R or $A. 

$S ADR/ ADD ACl>TABLE+3 

SA (OR S$A) Type out the address parts of symbolic instructions, and both 

addresses when the mode is halfword, as absolute numbers in the 
current radix . 

SA ADR/ ADD 4002 

$R (OR SSR) Type out addresses as relative addresses. 

SC (OR £SC ) Type out constants, i .e. , as numbers in the current radix. 

SC ABLE/ 2541 1 1 j >4050 

If the output radix is octal and the left half is not 0, the word 
will be divided into halves separated by commas. 
$F (OR S$F ) Type out the contents of storage words as floating-point numbers. 

$F X/ 0.1751 6230E-45 

Unnormalized numbers are typed out as signed decimal integers. 

IT (OR $$T) Type out as 7-bit ASCII text characters. Left- justified charac- 

ters are assumed unless the leftmost character is null . If the 
leftmost character is null, then right-justified characters are 
assumed . 

ST REX/ ABODE 



S6T (OR $S6T) Type out as SIXBIT text characters. 

S6T HEX/ ABCDEF 

S5T (OR $S5T) Type out symbols in radix 50 mode. (See MACRO- 10 Manual, 

Appendix 6.) 

S5T 13774/ 4 CREF ■ 40003^^261550 

£H (OR £SH) This command causes the typeout to be in halfwords, the left 

holf separated from the right half by double commas. The ad- 
dress mode interpretation is determined by $R or $A. 

SA $H Z/ 4503**4502 

SR £H Z/ TABL+14**TABL+13 



SNO (OR $$N0) Type out in n-bit bytes, where n is decimal. (Use the letter O, 

not zero) . 

S60 BYTS/ 22*23* 1* 73* 51* 46 
As in all DDT typeouts, leading zeros are suppressed. 
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4.3 BREAKPOINTS 

4.3.1 Setting Breakpoints 



The programmer can automatically stop his program at strategic points by setting up to eight 
breakpoints. Breakpoints may be set before the debugging run is started, or during another breakpoint 
stop. To set a breakpoint, the programmer types the symbolic or absolute address of the word at the 
location which he wants the program to stop, followed by $B. For example, to stop when location 
4002 is reached, he types, 

4002$B 
If all eight breakpoints are in use, DDT will type a question mark . The user may assign breakpoint 
numbers when he sets a breakpoint by typing ADR $nB, where n is the breakpoint number (l<ii<S). For 
example, 

SYM$3B ADR$7B 

If n is not entered DDT will assign 1 through 8 in sequence. In the previous example, when 
ADR is reached, DDT types, 

$7B >> ADR 
indicating that the break has occurred at location ADR, and breakpoint No. 7 was encountered. The 
break always occurs before the instruction at the breakpoint address is executed. 

If the instruction at the breakpoint location is executed by an XCT instruction, the typeout 
will show the address of the XCT instruction, not the location of the breakpoint. The program stops at 
each bl-eakpoint address, and the programmer can then type other commands to examine and debug his 
program. 

When the programmer sets a breakpoint, he may request that the contents of a word be typed 
out when a breakpoint is reached. To do this, the address of the word to be examined is inserted, 
followed by two commas, before the breakpoint address. 

X*,4002$2B 
When address 4002 is reached, DDT types out, 

$2B>>400g X/ ADD AC>Y+g 
where ADD AC, Y+2 is the contents of X. Location X is left open at this point. Location may not 
be typed out in this way because a zero argument implies no typeout. 

4.3.2 Removing Breakpoints 



The user may remove a breakpoint by typing, 

0$NB 
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where n is the number of the breakpoint to be removed. Therefore, 

0$2B 
removes the second breakpoint. All assigned breakpoints are removed by typing 

SB 
The user may reassign a breakpoint. If he has set breakpoint No. 2 at location ADR (ADR$2B), he may 
reassign No. 2 to ADR+1 by typing ADR+1$2B, 

4.3.3 Restrictions for Breakpoints 

Breakpoints may not be set on instructions that are 

a. Modified by the program 

b. Used as data or literals 

c. Used as part of an indirect addressing chain 

d. The user mode monitor command, I NIT 

A breakpoint at any other monitor command will operate correctly, except that if 
the monitor command is in error, the monitor will type out an error and the Program 
Counter, but the Program Counter will be internal to DDT and meaningless to the 
user. 

e. A breakpoint may not be assigned to accumulator 0. 

4.3.4 Restarting After a Bre akpoint Stop 

To resume the program after stopping at a breakpoint, the user types the proceed command, 

$P 

The program is restarted by executing the instruction at the location where the break occurred. If the 
user types n$P, this breakpoint will be passed n-1 times before a break can occur; the break will occur 
the nth time. If n is not specified, it is assumed to be one. If the user proceeds by typing $$P (or 
n$$P), the program will proceed automatically when the program breaks again. If DDT encounters an 
XCT loop or the monitor command INIT when proceeding, a question mark will be typed. 
Alternatively, the user may restart at any location by typing the start command, 
ADR$G 

where ADR is any program address, or $G, which restarts at the previously specified starting address in 
location JOBSA. 

4.3.5 Automotic Restarts from Breakpoints 



If the user requests DDT to type out the contents of a word and then continue program execu- 
tion without stopping, he types two ALTMODES when specifying the breakpoint address. 



AC#*ADRS$B 
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When ADR is encountered, the contents of AC are typed out and program execution contin- 
ues. To get out of the automatic proceed mode, type any Teletype key during the typeout, and then re- 
move the breakpoint or reassign it with a single ALTMODE. It may be necessary to use f C and DDT J 
to get back to DDT to remove or reassign the breakpoint. 

4.3.6 Checking Breakpoint Status 

The user may determine the status of a breakpoint by examining locations $nB, $nB+l, and 

$nB+2. 

$nB contains the address of the breakpoint in the right half and the address of the location to 
be examined in the left half. If both halves equal zero, the breakpoint is not in use. 

$nB+l contains the conditional breakpoint instruction. (See Paragraph 4.3.7.) 

$nB+2 contains the proceed count. 

4.3.7 Conditional Breakpoints 

Breakpoints may be set up conditionally in two ways. The user may provide his own instruc- 
tion or subroutine to determine whether or not to stop, or he may set a proceed counter which must be 
equal to or less than zero in order for a break to occur. 

When a breakpoint location is reached, DDT enters its breakpoint analysis routine consisting 

of five instructions. 

SKIPE $NB + 1 ; Is the conditional break instruction 0? 

)(Q1- $NB + 1 ; No, execute conditional break instruction 

SOSG $NB+2 ; Decrement and test the proceed counter 

j^ST break routine 

JRST proceed routine 

If the contents of $nB+l are zero (indicating that there is no conditional instruction), the 
proceed counter at $nB+2 is decremented and tested. If it is less than or equal to zero, a break occurs; 
if it is greater than zero the execution of the user's program proceeds with the instruction where the 
break occurred. 

If the conditional break instruction is not zero, it is executed. If the instruction (or the 
closed subroutine) does not cause a program counter skip, the proceed counter is decremented and tested 
as above. If a program counter skip does occur, a break occurs. If the conditional instruction is a call 
to a closed subroutine which returns skipping over two instructions, execution of the user's program pro- 
ceeds . 
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If the user wishes a break to occur based only on the conditional instruction, he should set 
the proceed counter to a large positive number so that the proceed counter will never reach zero. 

^'^ •'^- ^ Using the Proceed Co unter - If the user wishes to proceed past a breakpoint a specified 
number of times, and then stop, he inserts the number of passes in $nB+2, which contains the proceed 
count . 

The proceed counter may be set in two ways. The first way is by direct insertion. For 
example, 

$NB+2/ _0_ 20 
sets the counter to 20. The second method is as follows. After stopping at a breakpoint, the proceed 
count may be set (or reset) by typing the count before the proceed command: 

20$P 

($P will proceed from the interrupted instruction sequence even if the breakpoint has been removed or 
reassigned.) 

^•'^•^•2 Using the Conditional Break Instruction ~ The user inserh a conditional instruction, or a call 
to a closed subroutine at $nB+l . For example, 

$38+1/ _0 CAIGE ACC^ISJ 
or 

$48 + 1/ _0_ JSA 16, test; 

When the breakpoint is reached, this instruction or subroutine is executed. If the instruction does not 
skip or the subroutine returns to the next sequential location, the proceed counter is decremented and 
tested, as explained in Paragraph 4.2.7. If the instruction skips or the subroutine returns skipping over 
one instruction, the program breaks „ If the subroutine causes a double skip return, the program pro- 
ceeds with the instruction at the breakpoint address. 

Examples of Conditional Breakp ints 

If address 6700 is reached and DDT's No. 4 breakpoint registers are as follows: 

548/ AC1,,6700 

$48+1/ CAIE AC1,100 

$48+2/ 200 

ACl contains 100, and DDT types 

$4B>6700 ACl/ 100 
Since ACl contains 100, the compare instruction skips and the program breaks. If ACl did not contain 
100, $4B+2 would be decremented by one and the user's program would continue running. 
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If the conditional break instruction transfers to a subroutine which, after the subroutine is 

executed, returns to the calling location +3, a break will never occur regardless of the proceed counter. 

Example: If the internal DDT breakpoint registers ($2B and $2B+1) have the following contents, a break 

would not occur unless accumulator 3 contains 100. 

$28/ ADR 

$28 + 1/ JS R TEST , . o^ . .<•« . . 

(contains PC when JSR to subroutine 

TEST/ TEST is made) 

TEST+1/ AOS TEST 

TEST+2/ CAIE 3W00 

TEST+3/ AOS TEST 

TEST+4/ JRST @ TEST 

The subroutine TEST causes a double skip (the return is to the third instruction after the call) in DDT if 
accumulator 3 does not equal 100. A break will never occur at address ADR (regardless of the proceed 
counter) unless accumulator 3 contains 100, 

4.3.8 Entering DDT from a Breakpoint 

When a break occurs, the state of the user's program is saved, the JSR breakpoint instructions 
are removed, and the programmer's original instructions are restored to the breakpoint locations. DDT 
types out the number of the breakpoint and a symbol indicating the reason for the break, >for the con- 
difional break instruction, »for the proceed counter and the address in the user's program where the 
break occurred . 
Example; If address ADR is reached in the user's program and DDT's breakpoint registers contain: 

$28/ ADR 

$28 + 1/ &_ 

$28+2/ _0 (proceed counter contains zero) 

DDT stops the program and types, 

$2B> >ADR 

4.4 SEARCHES 



There are three types of searches: the word search, the not-word search, and the effective 
address search. 

Searches can be done between limits. The format of the search command Is, 

W Word search 

a<b >c$ ( N Not-word search 

E Effective address search 
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where: 

a^ Is the lower limit of the search; is assumed if this argument and its delimiter are not 
present . 

b Is the upper limit of the search. The lower numbered end of the symbol table is assumed 
if this argument and its delimiter are not present. 

£ Is the quantity searched for. 

The effective address search (E) will find and type out all locations where the effective 

address, following all indirect and index-register chains to a maximum depth of 64,^ levels, equals 

the address being searched for. 

Examples: 

4517<5000>XSE 

INPUT <5000>700$E 
Examples of DDT output, when searching for X in the above example, are as follows. 

4517/ SET2M X 

4721/ MOVE 2>X 

cniaffl ^ i..,,^.,r- ^ ^ «^ (indirectly addresses X through 

5000/ MOVE 3^ @ 4721 ^ , , AJO]) 



The word search (W) and the not-word search (N) compare each storage word with the word 
being searched for in those bit positiorv where the mask, located at $M, has ones. The mask word con- 
tains all ones unless otherwise set by the user. If the comparison shows an equality, the word search 
types out the address and the contents of the register; if the comparison results in an inequality, the 
word search will type out nothing. The not-word search types nothing if an equality is reached. It 
types the contents of the register when the comparison is an inequality. 
Examples: 

INPT<INPT+10>NUM$W 

INPT<INPT+10>0SN 

SM^ This command types out the contents of the mask register, which is then 

open. The contents of the mask register are ordinarily all ones unless 
changed by the user . 

N£M Inserts n into the mask register. 

0$M FIRST <LAST>0$W Lists a block of locations by setting the MASK to 

zero then performing a word search for zero. 
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4.5 MISCELLANEOUS COMMANDS 

$Q This command represents the value of the last quantity typed. 

ADR/100**S00 $Qi puts back in ADR the quantity 100,200. 

$0+1; puts back in ADR the quantity 100,201. 
$Q/ displays the contents of location 200. 
$Q+l/dispIays the contents of location 201 . 

$V This command reverses the two halves of the word and then 

represents the value of the last quantity typed. 

ADR /1 00** 200 $VJ puts back in ADR the quantity 200,100. 

$V+i; puts back in ADR the quantity 200, 101 . 
$V/displays the contents of location 100. 
$V+l/displays the contents of location lOl. 

inst$X This command causes the instruction inst to be executed. 

JRST ADRSX starts the user's program at ADR. 

FIRST <LASTS$Z This command zeros the memory locations between the indicated FIRST 

and LAST address inclusively. If the first address is not present, location 
is assumed. If the last address is not present, the location before the low- 
numbered end of the symbol table is assumed. Locations 2Q-137, DDT, 
and the symbol table are not zeroed. 

SY This command causes a command file to be read and executed. In user mode, 

the default name for the command file is DSK: PATCH. DDT. The command 
string $"/NAME/$Y causes the file DSKrNAME.DDT to be interpreted. 
In exec mode, the command reads a command file from the paper tape reader. 

When DDT is reading a command file, rubouts and the character immediately 
following a carriage return (assumed to be a linefeed) are ignored. Any 
sequence of DDT commands including $X, $G is legal. 

The ? error message is given If (1) a lookup failure occurs on the command 
file, or (2) this command is not implemented. 
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CHAPTER 5 
SYMBOLS AND DDT ASSEMBLY 

A symbol is defined in DDT as a string of up to six letters and numbers including the special 
characters period ( . ), percent sign (%), and dollar sign ($). Characters after the sixth are ignored. 
A symbol must contain at least one letter. If a symbol contains numerals and only one letter, that letter 
must not be a B, D, or an E. These letters are reserved for binary-shifted and floating-point numbers. 

Certain symbols can be referenced in one program from another. These symbols are called 
"global". Those which can only be referenced from within the same program are called "local" or "in- 
ternal". Any symbol which has been defined as global by MACRO-10 (using the INTERNAL or ENTRY 
statements) will be considered as global by DDT-10 when it is referenced. FORTRAN subroutine entry 
points and COMMON block names are globals. All symbols which the user defines via DDT are defined 
or redefined as global symbols. 

The user may want to reference a local symbol within a particular program. In order to do 
this he should first type the program name followed by $: . Thus, if a user wishes to use a symbol local 
to program MIN, he types the command, 

MIN$: 
This commarKi unlocks the symbol table associated with MIN. DDT allows the user to reference unique 
local symbols in other programs without respecifying the program name with $: (see Section 5.6.2). 
However, to access a local symbol that is used in several programs, the user must specify the program 
name to remove the ambiguity. The program name is that specified in the MACRO-10 TITLE statement. 
In FORTRAN, the program name is either MAIN., the name from the SUBROUTINE or FUNCTION 
statement, or DAT. for BLOCK DATA subprograms. 

5.1 DEFINING SYMBOLS 

There are two ways to assign a value to a symbol . 

NUMERIC VALUE < SYMBOL: This command puts SYMBOL into DDT-lO's symbol 

table with a value equal to the specified NUMERIC 
VALUE. SYMBOL is any legal symbol defined or 
undefined. 

Example: 

305<XVAR» 

XVAR has now been defined to have the value 305. 

TAG: This command puts TAG into DDT-lO's symbol table 

with a value equal to the address of the location 
pointer. 
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Example: 



400/ ADD 2, 120 12 X: 

This pufs the symbolic tag X into DDT-lO's symbol 
table and sets X equal to 400, the address of the 
last register opened . 



5.2 



DELETING SYMBOLS 



There are times when the user will want to restrict or eliminate the use of a certain few de- 
fined symbols. The following three ways give the user of DDT- 10 these capabilities. 

SYMBOL $$K SYMBOL is killed (removed) in the user's symbol table. SYMBOL can 

no longer be used for input or output. 

Example: 
XS$K 



SYMBOL $K 



$D 



This command removes the symbol X from the symbol table. 

This command prevents DDT from using this symbol for typeout; it can 
still be used for typein. For example, the user may have set the same 
numeric value to several different symbols. However, he does not wish 
certain symbol (s) to be typed out as addresses or accumulators. 

^^ WVE J* SAV J$K - MOVE N> SAV NSK - MOVE AC*SAV 

Since the user does not wish J to be typed out as an accumulator, he 
types in J$K, followed by a left arrow to type out the contents of X 
again and MOVE N,SAV is typed out. He then repeats the above pro- 
cess until the desired result, namely AC, is typed out. Any further 
symbolic typeouts with the same number in the accumulator field of the 
instruction will type out as AC. 

The last symbol typed out by DDT has $K performed on it. The value of 
the last quantity output is then retyped automatically. For example, 

A/ MOVE AC*LOC $D MOVE AC*ABC+1 



5.3 



DDT ASSEMBLY 



When improvising a program on-line to the PDP-10 on a Teletype, the user will want to use 
symbols in his instructions in making up the program. In this and in other situations, undefined symbols 
may be used by following the symbol with the number sign (^). The symbol will be remembered by DDT 
from then on. Until the symbol is specifically defined by the use of a colon, the value of the symbol is 
taken to be zero. Successive use of the undefined symbol causes DDT to type out ". Appending ^ to 
all subsequent uses of the symbol enables the user to readily identify undefined (not yet defined by a 
colon) symbols. When an undefined symbol is finally defined, all previously tagged (*) occurrences of 
the symbol will be filled in. 
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Example: 

MOVE 2 > VALUE* 
VALUE Is now remembered by DDT and may be used further without the user appending the *. If subse- 
quent instructions are given Involving VALUE, DDT appends a # automatically to that symbol . Thus 
VALUE will always appear as VALUE followed by the # (until VALUE Is defined). 
Example: 

START! MOVE 2, VALUE* I (user types the #) 

START+1 I ADDI 2* 50^ 

START -t-g! MOVEM 2# VALUE j 

^ (DDT types #) 

START +3! JRST VALUE+£1 1 (DDT types # after the plus sign be- 

START+4! cause only at that point does DDT 

realize the symbol VALUE is complete.) 

Undefined symbols can be used only In operations Involving addition or subtraction. The undefined 

symbols may be used only In the address field. 

Example: 

MOVEI 2*3*UNDEF# 

This is an illegal operation - multiplication with a symbolic tag (UNDEF) which has not pre- 
viously been defined. 

The question mark (?) Is a command to DDT to list all undefined symbols that have been used 

In DDT up to that point In the program. 

Example; 

? 

VALUE 

UNDEF 

5.4 FIELD SEPARATORS 

The storage word Is considered by DDT to consist of three fields: the 36-bit wholeword field; 

the accumulator or \/0 device field; and the address field. Expressions are combined into these three 

fields by two operators: 

Space The space adds the expression immediately preceding it (normally an op 

code) into the storage word being formed. It also sets a flag so that the 
expression going into the address field is truncated to the rightmost 18 
bits . 
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Single Comma The comma does f-hree things: the left half of the expression is 

added into the storage word; the right half is shifted left 23 bits 
(into the accumulator field) and added into the storage word. If 
the leftmost three bits of the storage word are ones, the comma 
shifts the right half expression left one more place (I/O instruc- 
tions thus shift device numbers into the device field). The com- 
ma also sets the flag to truncate addresses to 18 bits. 

Double Comma Double commas are used to separate the left and right halves of 

a word with contents expressed in halfword mode. 

The address field expression is terminated by any word termination command or character. 

5.5 EXPRESSION EVALUATION 

Parentheses are used to denote an index field or to interchange the left and right halves of 
the expression inside the parentheses. DDT handles this by the following generalized procedure. 

A left parenthesis stores the status of the storage-word assembler on the pushdown list and re- 
initializes the assembler to form a new storage word. A right parenthesis terminates the storage word 
and swaps its two halves to form the result inside the parentheses. This result is treoted in one of two 
ways : 

a. If +,-,', or * immediately precede the left parenthesis, the expression is treated as 

a term in the larger expression being assembled and therefore may be truncated to 18 bits if part of the 
address field . 

b. If +,-,', or * did not immediately precede the left parenthesis, this swapped quantity 
is added into the storage word. 

Parentheses may be nested to form subexpressions, to specify the left half of an expression, or 

to swap the left half of an expression into the right half. 

5.6 SYMBOL EVALUATION 
5.6.1 Order of Symbol Table Search 



DDT references two symbol tables: (1) a built-in operation table containing the machine 
language instructions and monitor UUOs (e.g., MOVE, JRST, and INIT) and (2) a symbol table con- 
structed by LOADER during the loading process, containing all the user-defined symbols. When a user 
types into DDT a symbol, which must be converted into a binary value, DDT has two places to look for 
the symbol . If the expression (see Section 5.5) constructed has a zero value (the normal case when 
typing in the operation code of an instruction such as the JRST part of a JRST ADDRESS instruction), 
DDT looks for the symbol first in its internal operation table, and then, if the symbol is not found, in 
the LOADER constructed symbol table. If the expression constructed is non-zero, DDT searches the 
LOADER constructed table first, and then the internal operation table. This method of searching the 
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fables allows Insfrucfrions such as JRST JRST to work correctly (the first JRST is an operation code, and 
the second JRST is a user-defined address location). 

5.6.2 Order of Symbol Table Searc h for Symbol Evaluation 

When DDT searches the jLOADER constructed symbol table to evaluate a symbol typed in, it 
begins the search by looking through the symbols specified by <program name>$: (see Section 2.5). 
DDT searches the table in the following order: 

1 . Looks for the symbol as a local or global symbol in the currently unlocked (by $:) pro- 
gram symbols. 

2. Looks for the symbol as a global symbol anywhere in the symbol table. 

3. Looks for the symbol as a local symbol in the symbol table of one and only one program. 

4. Looks for the symbol as a local symbol that appears in the symbol table of more than one 
program, but with the same value in each table. (If the symbol appears with different 
values in different tables, it will not be recognized as defined because there is no way 
to resolve the ambiguity.) 

5. If all the above fail, the symbol is undefined unless it appears in the internal operation 
table of the DDT. 

Fortunately, the searching is accomplished with a single pass over the symbol table. 

If one of the several identical local symbols (in step 4) is redefined, it becomes a global, 
and the symbol is then found at either step 1 . or step 2 . 

This procedure relaxes the requirement of Sections 2.5, 3.6, and the beginning of Chapter 5 
on the use of $: to unlock local symbols. 

5.7 SPECIAL SYMBOLS 

The @ sign sets the indirect bit in the storage word being formed. 
Example: 

MOVE AC*@X 

5.8 BINARY VALUE INTERPRETATION 

When DDT is typing the symbolic equivalent of a binary word or address, it looks for the sym- 
bol with a value that best matches the binary. DDT looks through the symbol values in the following 
order: 

1 . Searches the symbols of the currently unlocked (by $:) program for a local or global sym- 
bol with a value that exactly matches the binary to be interpreted. 

2. Searches for a global symbol outside the currently unlocked program with a value that 
exactly matches the binary to be interpreted. 
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3. Searches all fhe ofher local symbol tables for one or more entries with values that match 
the binary to be interpreted. If more than one symbolic equivalent is found, the DDT 
does not use any of them but goes on to step 4. If exactly one symbolic equivalent is 
found (this includes the case of the same symbol with the same value in more than one 
local symbol table), then this symbol is used. However, the symbol has a * appended to 
it to warn the user that this symbol might have a different value in some other local sym- 
bol table. 

4. Searches the currently unlocked program symbols for a local symbol, and searches the 
entire symbol table for a global symbol, with the value closest to but less than the binary 
to be interpreted. The closest symbol is then used for typeout if it is not more than 64 
smaller than the binary being interpreted. 

If a usable symbol is not found in any of the above steps, the binary is typed out as an integer in the 

current output radix. 

The purpose of this complicated procedure is to output the best symbol without forcing the 

user to continually respecify the program symbol table names by using $:. 
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CHAPTER6 
PAPER TAPE 



DDT 



6.1 



PAPER TAPE CONTROL 



The following commands are used in pajjer fape control; 



$L 



FIRST<LAST (jAPf) 



FIRST<LAST $ ^p|) 



ADR$J 



This command causes DDT to punch a RIM 1 OB loader on paper 
tape RIMIOB loader. (See MACRO- 10 Manual, Chapter 6.) 
Thus, If the user wishes to punch out d program on paper tape he 
gives d $L command first In order to get a loader punched on the 
same tdpe as the program. Later when the user wishes to read In 
the program from the paper tape, the hardware READ-IN feature 
will load the RIMIOB loader Into the accumulators and then the 
program will be loaded by the RIMIOB loader. (See Figure 6-1 .) 

This command punches out checksummed blocks In RIMIOB format 
on poper tape from consecutive locations between FIRST and 
LAST address Inclusively. For example, this command will punch 
out q program existing In core memory In Its present state of 
check-out for later use. 

Example; 



4000<20000 QTAPI 

This command Is similar to the preceding command, except that 
locations whose contents are zero are not punched out whenever 
more than two consecutive zeroes are detected. 

This command punches a 2-word block that causes a transfer to 
address ADR after the preceding program has been loaded from 
paper tape. If ADR Is not present, a JRST 4, DDT Is punched as 
the first word . 



The following succession of steps will punch a program on paper tape ready to be used as an 

Independent entity. 

$L 

2 



a. 
b. 



5000<20000 (TAPE) 

6000SJ (Transfer to address 6000 after program Is loaded.) 



- T he p aper tape functions are not available in the timesharing user mode version of DDT. 
(tape) Is a single control key on the Teletype, and Is Identical to t R (control-R). 
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Typed in: 



$L 



FIRST ADDRESS < 
LAST ADDRESS CfAPE) 



SA$J 



tape feed 



RIM10B 
LOADER 



fape feed 



-WC I FA-1 



DATA 
BLOCK 



CHECKSUM 



tape feed 



DATA 
BLOCK 



DATA 
BLOCK 



tape feed 



JRST SA 




Beginning of Tape 



Checksum includes pointer word 
WC = word count 



transfer block 

SA = starting address 



Figure 6-1 RIMIOB Block Format 



6-2 



-907- 

APPENDIX A 
SUMMARY OF DDT FUNCTIONS 



DDT 



A.l TYPE-OUT MODES 



The following are used to set the type-out mode: 





Type 


Sample Output (s) 


Symbolic Instructions 


$S 


ADD 4# TAG+1 
ADD 4# 4002 


Numeric, In current radix 


sc 


69. 

105 


Floating point 


$F 


0.125E-3 


7-bit ASCII text 


ST 


PQRST 


SIXBIT text 


S6T 


TSRQPO 


RADIX50 


$5T 


4 DDTEND 


Halfwords, two addresses 


$H 


400S»>4005 
X+l##X+4 


Bytes (of n bits each) 


$N0 


S80 COULD YIELD 
0#I4*237#123*0 



A. 2 



ADDRESS MODES 



The following are used to set the address made for typeout of symbolic instructions and half- 
words (see examples above): 



Relative to symbolic address SR 

Absolute numeric address SA 



TAG + 1 
4005 



A.3 RADIX CHANGE 

The following Is used to change the radix of numeric type-outs 



to n (for n>2): 



SNR. $2R COULD YIELD 
110101 10000001000000000001 1 100101 100 



A.4 PREVAILING VS. TEMPORARY MODES 

The following are used in prevailing vs. temporary modes: 



To set a temporary type-out or 
address mode or a temporary 
radix as shown in the commands 
above, type 



$C . 
S10R 
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To set a prevailing type-out 
or address mode on a prevail- 
ing radix, in the commands 
above, substitute 

To terminate temporary modes 
and revert to prevailing modes, 
type a carriage return 

Initial prevailing (and tempo- 
rary) modes are 
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Type 

$$ 



35SS 
S$8R 



Sample Output (s) 



$$C 
$$ 1 0R 



A. 5 STORAGE WORDS 

The following are used to examine storage words: 

To open and examine the con- 
tents of any address in current 
type-out mode 

To open a word, but inhibit the 
type out of contents 



To open and examine a word as 
a number in the current radix 

To open and examine a word as 
a symbolic inptrucfion 

To retype the last quantity typed 
(particularly used after changing 
the current type-out mode) 



adr/ 



adrl 



adr[ 



adr] 



LOC / g54020>>DDTEND 

LOC! 

LOCt 254020^^3454 

LOC 3 JRST ePDTEND 

S60; 25*40*20*00,34*54 

$6TJ 5%0 <L 



A. 6 RELATED STORAGE WORD 

The following are used to examine related storage words: 

To close the current open word 
(making any modification typed 
in) and to open the following re- 
lated words, examining them in 
the current type-out mode: 

To examine ADR+1 



To examine ADR-1 



1 (line feed) 

t (or backspace, 
on the Teletype 
Model 37) 
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To examine the contents of the location 
specified by the address of the last 
quantity typed, and to set the location 
pointer to this address 

To examine the contents of address of 
last quantity typed, but not change the 
location pointer 

To close the currently open word, with- 
out opening a new word, and revert to 
permanent type-out modes 



Type 



H (TAB) 



\ (backslash) 



DDT 

Sample Output (s) 



^ (carriage return) 



A. 7 ONE-TIME ONLY TYPEOUTS 

The following typeouts occur only one time: 

To repeat the last typeouf as a number 
in the current radix 

To repeat the last typeouf as a symbolic 
instruction (the address part is deter- 
mined by $A or $R) 

To type out, in the current type-out 
mode, the contents of the location spe- 
cified by the address in the open in- 
struction word, and to open that loca- 
tion, but not move the location pointer 

To type out, as a number, the contents 
of the location specified by the open 
instruction word and to open that loca- 
tion, but not move the location pointer 

To type out, as a symbolic instruction, 
the contents of the location specified by 
the open instruction word, and to open 
that word, but not move the location 
pointer 



/ 



A. 8 TYPING IN 

Current type-out modes do not affect typing in; instead, the following are performed: 

To type in a symbolic instruction ADD AC 1 >§DATE( 1 7 ) 

To type in half words, separate the left 

and right halves by two commas 402 * « 403 



To type in octal values 

To type in a fixed-point decimal in- 
teger 



1234 



99. 



A-3 



DDT 



-910- 



To type in a floating-point number 

To type in up to five 7-bit PDP-10 
ASCII characters, left justified, delim- 
ited by any printing character 

To type in one PDP-10 ASCII character, 
right justified 

To type in up to six SIXBIT characters, 
left justified, delimited by any printing 
character 

To type in one SIXBIT character, right 
justified 



Type 


Sample Output (s) 


101 .11 




77.0E+2 




•VABCDE/ 


(/is delimiter) 


"AS 


($ must be ALTMODE) 



$"ABCDEFGA 



$"Q$ 



(A is delimiter) 

($ must be ALTMODE) 



A. 9 SYMBOLS 

The following are DDT symbols: 

To permit reference fro local symbols 
within a program titled name 

To insert or redefine a symbol in the 
symbol table and give it the value n 



name$: 
n< symbol : 



MAIN.£: 



14<TABL3 



To insert or redefine a symbol in the 
symbol table, and give it a value equal 
to the location pointer ( . ) 

To delete a symbol from the symbol 
table 

To kill a symbol for typeouts (but still 
permit it to be used For typing in) 

To perform $K on the last symbol typed 
out and then to retype the last quantity 

To declare a symbol whose value is to 
be defined later 

To type out a list of all undefined sym- 
bols (which were created by '^ ) 



symbol : 


SYM: 


symbol $$K 


LPCTSSK 


symbol $K 


TBITS$K 


$D 




symbol* 


JRST AJAX# 


? 





A. 10 SPECIAL DDT SYMBOLS 

The following are special DDT symbols: 

To represent the address of the location 
poipter 

To represent the last quantity typed 



. (point) 
$Q 
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A.n 



To represent the last quantity typed, 
halves reversed 

To read and execute a command file 

To represent the indirect address bit 

To represent the address of the search 
mask register 

To represent the address of the saved 
flags, etc. (see Appendix D) 

To represent the pointers associated 
with the nth breakpoint 

ARITHMETIC OPERATORS 



Type 
$V 

$Y 

@ 
$M 

$1 
$nB 



Sample Output (s) 



The following arithmetic operators are permitted in forming expressions: 
Two's complement addition + 

Two's complement subtraction 
Integer multiplication * 

Integer division (remainder discarded) ' (apostrophe) 



A. 12 FIELD DELIMITERS IN SYMBOLIC TYPE-INS 

The following are field delimiters: 
To delimit op -code name 
To delimit accumulator field 
To delimit two halfwords 
To delimit index register 
To indicate indirect addressing 



one or more spaces 
, (comma) 
left,, right 

( ) 



JKST SUBRTE 



-6**BEGIN-1 



A. 13 BREAKPOINTS 

The following are used for breakpoints: 

To set a specific breakpoint n(l<n<8) 

To set the next unused breakpoint 

To set a breakpoint with automatic pro- 
ceed 

To set a breakpoint which will automat- 
ically open and examine a specified ad- 
dress, X 



Version 34 DDT 
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adr$nB 


CAR$8B 


adr$B 


303$B 


adr$$nB 


CAR$$8B 


adr$$B 


303$$B 


X, ,adr$nB 


AC3**Z+6$5B 


x,,adr$B 


AC4**ABLE$B 


x,,adr$$nB 


AC3**Z+6$$5B 


X, ,adr$$B 


AC4*>ABLES$B 
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To remove a specific breakpoint 

To remove all breakpoints 

To check the status of breakpoint n 

To proceed from a breakpoint 

To set the proceed count and proceed 

To proceed from a breakpoint and 
thereafter proceed automatically 



Type 


Sample Output(s) 


0$nB 


0$8B 


$B 


$B 


$nB/ 




$P 


$P 


n$P 


25$P 


$$P 


$$P 


n$$P 


25SSP 



A . 14 CONDITIONAL BREAKPOINTS 

The following are used for conditional breakpoints: 

To insert a conditional instruction 
(INST), or call a conditional routine , 
when breakpoint n is reached $nB+l/ 

$2B+l/0 

If the conditional instruction does not 
cause a skip, the proceed counter is 
decremented and checked . If the pro- 
ceed count <0, a break occurs 

If the corKJitional instruction or subrou- 
tine causes one skip, a break occurs. 

If the conditional instruction or subrou- 
tine causes two skips, execution of the 
program proceeds. 



INST 
CAIE 



3^100 



A . 15 STARTING THE PROGRAM 

The following commands are used to start the program: 

To start at the starting address in JOBSA $G 

To start, or continue, at a specified ad- 
dress adr$G 

To execute an instruction inst$X 



$G 



LOC$G 



JRST 2* ejOBOPCSX 
returnis to program after 
t C and DDT commands 



A. 16 SEARCHING 

The following commands are used for searching: 

To set a lower limit (a), an upper limit 
(b), a word to be searched for (c), and 
search for that woi'd 



a<b>c$W 



200<2 50>0$W 
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To set limits and search tor a not-word 

To set limits and search for an effective 
address 



Type 
a<i3>c$N 

a<b>c$E 



To examine the mask used in searches 
(initially contains all ones) $M/ 

To insert another quantity n in the mask n$M 



Sample Output(s) 
351<731>0$N 

401<471>LOC+6$E 

$M/ -1 
777000777777SM 



A. 17 UNUSED FUNCTIONS 

I The following is unused: 

$U 



A. 18 ZEROING MEMORY 

The following are used for zeroing memory: 

To zero memory, except DDT, loca- 
tions 20-137, and the symbol table 

To zero memory locations FIRST through 
LAST inclusive 



$$Z 
FIRSt<LAST $$Z 



A. 19 SPECIAL CHARACTERS 

The following special characters are used in DDT typeouts: 
Breakpoint stops 



Break caused by conditional break 
instruction 



> 



Break because proceed counter < >> 

Undefined symbol cannot be assembled U 

Half-word type -outs left,, right 

Unnormalized floating-point number *1 .234E+27 

To indicate an integer is decimal . The 

decimal point is printed $10R 77=63. 

Illegal command ? 

If all eight breakpoints have been as- 
signed ? 

RUBOUT echo XXX 



401 »,A^2 
»\ .234E+27 



Revision 1 DDT 
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PAPER TAPE COMMANDS 



The following commands are available only in EDDT: 



Type 



Sample Output(s) 



To punch a RIMIOB loader 

To punch checksummed data blocks 
where ADR1 is the first, and ADR2 is 
the last location of the data 

To punch data as above, except that 
more than two consecutive locations 
containing zeros are not punched. 

To punch a one-word block to cause a 
transfer to adr after the preceding pro- 
gram has been loaded from paper tape 



$L 



ADRl <ADR2 (TAPE) 

ADRl <ADR2$ ^ 
((TAPE)is tR) 

adr$J 
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APPENDIX B 
EXECUTIVE MODE DEBUGGING (EDDT) 

A special version of DDT, called EDDT, is available for debugging programs in the executive 
mode of the PDP-10. EDDT also runs in user mode under the monitor and performs the same debugging 
functions as user-mode DDT. EDDT requires somewhat more memory space than DDT; therefore, it is 
normally used only with hardware diagnostics and the monitor. All of the paper tape commands are 
available in EDDT (those in DDT are marked by an asterisk in Chapter 5). The paper tape l/O routines 
in EDDT are optional at assembly time. 

EDDT is used to debug monitor programs, diagnostic programs, and other executive (or priv- 
ileged) programs. EDDT performs its own l/O on a Teletype and controls the Priority Interrupt system. 
It does not check X)BREL for boundary limits as DDT does. 

In EDDT the symbol table pointer is in location 36 and the undefined-symbol table pointer is 
in location 32. If the NXM STOP switch is ON, the machine will hang up if nonexistent memory is 
referenced. If this happens, EDDT may be restarted by pressing START, or the CONTINUE switch may 
be pressed . 

Stand-alone programs should initialize EDDT by placing the contents of .JBSYM (116) into 
location 36, and .JBUSY (117) into location 32. 

The first address of EDDT is DDT; the last is DDTEND. 

The $$Z command will not zero locations 20 through 37. (In the user mode version, $$Z 
does not zero locations 20 through 137. See Section 4.5.) 
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APPENDIX C 
STORAGE MAP FOR USER MODE DDT 

See Figure C-1 . The permanent symbol table, which contains all PDP-10 instructions and 
monitor UUOs, is an integral part of DDT. 

If the user's symbol table is overwritten DDT can still interpret all instructions and UUOs. It 
will not interpret l/O device mnemonics, internal $ symbols ($M, $1, $1B through $8B), DDT and 
DDTEND or the following: 
JOV 
JEN 
HALT 



User 
Area 
(low 
seg- 
ment) 



400000 



DDT 



User's Symbol Table 



high segment 
(optional) 













JOBREL (points to highest location in user area) 

JOBDDT (XWD DDTEND, DDT) 

JOBSYM (XWD - WC, 1st address of symbol table) 

1st address is DDT 
Last address is DDTEND 



1st address of symbol table 
Highest location in low segment 



Figure C-1 Storage Map for User Mode DDT 
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APPENDIX D 
OPERATING ENVIRONMENT 



D.l ENTERING AND LEAVING D DT 

When control is transferred to DDT, the state of the machine is saved inside DDT: 

a . The accumulators are saved . 

b. The status of the priority interrupt system (the result of a CONI PI/ $1) is stored in the 
right half of register $1. 

c. The central processor flags are saved in the left half of register $1. 

d.^ The PI channels are turned off (by a CONO PI, @$I+1) if they have a bit in register 
$1+1 . 

e. The Teletype PI channel is saved in the right half of register $1+2. The Teletype buffer 
is saved in the left half of $1+2 but can never be restored . The character in the output buffer will have 
been typed on the Teletype . 

f . If DDT was entered via tCtC and the monitor DDT command, the old program counter 
word is saved in location JOBOPC. 

When execution of a program is restarted, the following happens: 

a . The accumulators are restored . 

b. Those PI channels which were on (when DDT was entered) and which have a bit equal to 



(C($I)„AC($I+1)_) V2000-PI SYSTEM 

K K 



1 in register $1+1 are turned on. 

(C($i)^AC(: 

(logicdl AND (A), logical OR (V)) 

c. The Teletype PI channel is restored. 

- TTI DONE - TTI BUSY - TTO BUSY 
TTO done is set to 1 if either TTO busy or TTO done was on when DDT was entered . Otherwise 
-* TTO done . 

d. The processor flags are restored from the left half of register $1. 

e. To return to a program interrupted by tC, the user types: 

JRST 2* § JOBOPCSX to restore the PC and flags. 



Functions not available in the timesharing user mode, 
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D.2 LOADING AND SAVING DDT 

Load and save DDT.SAV in 2K of core in the following manner: 



Instructions 



(1) Load DDT. 



(2) Enter DDT. 

(3) Type out, in halfword mode, the contents 
of JOBSYM. 

(4) Open register 6, and put (JOBSYM)[jh 
into left half of 6; put ((JOBSYM)rh 
AND2 1777) + 2000 into right half of 6. 

(5) Perform a block transfer stopping at 3777. 

(6) Open JOBSYM; leave the left half as is 
and change the right half to 
((JOBSYM),^^^ ANd2 1777) + 2000. 

(7) Zero memory, except for DDT. 

(8) Start over at 140 to initialize the new 
symbol table. 

(9) Open JOBSA and put DDTEND in the 
left half and DDT in the right half. 

(10) Change back to symbol type-out mode. 

(1 1) Return to monitor. 

(12) Reduce core to 2K . 

(13) Reenter DDT. 

(14) Check that JO BREL is 2K. 

(15) Return to monitor . 

(16) Save DDT. 

(17) Check start address. 



Example 

.R LOADER 
*DSK:DDT$ 
LOADEH 
EXIT 

TC 

^ST 140 

S$H JOBSYM/ -1 12^,5666 



6! 5666**3666 
BLT 6*3777$X 

JOBSYM/ - 112**5666 -112**3666 

S$Z 

140$G 

JOBSA! DDTEND**DDT 

$$S 

tC 

iCORE 2 

iDDT 

JOBREL/ 3777 

fC 

iSAVE DSK DDT 

iSTART 
./ 3777 



ALTMODE is indicated by $. 
Logical AND. 
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D.3 EXPLANATION 

The PDT saved file must be saved in 2K (minimum amount of core needed). Also, a starting 
address must be set up for DDT as lopation 140. To get DDT into 2K, the DDT symbol table must be 
moved down to the upper end of the first 2K of core. Any unused locations in DDT should be set to 
zero ($$Z) and JOBSYM should be set to the new location of the start of the DDT symbol table . Before 
saving the resulting file, a CORE 2 request should ^e given to the monitor to ensure that DDT is saved as 
a 2K core image. 
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